Obtains a handle to the GDevice structure associated with an offscreen graphics world.

GDHandle GetGWorldDevice (
    GWorldPtr offscreenGWorld
);

offscreenGWorld

A pointer to an offscreen graphics world. The pointer returned to your application by the NewGWorld function.

function result

A handle to the GDevice structure associated with the offscreen graphics world specified by the offscreenGWorld parameter.

If you created the offscreen world by specifying the noNewDevice flag, the GDevice structure is for one of the screen devices or is the GDevice structure that you specified to NewGWorld or UpdateGWorld.

If you point to a GrafPort or CGrafPort structure in the offscreenGWorld parameter, GetGWorldDevice returns the current device.

SPECIAL CONSIDERATIONS

The GetGWorldDevice function may move or purge memory blocks in the application heap; do not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when InterfaceLib 7.1 or later is installed. Exported by CarbonLib 1.0 and later and by InterfaceLib 7.1 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)